home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_licq.idb / usr / freeware / doc / licq / README.z / README
Text File  |  2002-04-08  |  4KB  |  115 lines
  1. LICQ v1.0.4
  2.  
  3. An ICQ clone written in C and C++ using a plugin system to allow for
  4. many possible interfaces.  
  5. See the webpage (http://www.licq.org) for more information.
  6. Licq implements messages (online and offline), urls, chat, full file
  7. transfer, gui configuration (with the qt-gui plugin), history as 
  8. well as a number of other features.
  9.  
  10.  
  11. LICENSE
  12.  
  13. This program is licensed under the terms of the GNU GPL, a copy
  14. of which you should have received with this package.
  15.  
  16.  
  17. INSTALLATION:
  18.  
  19. (If you have a binary distribution then see the FAQ for how to
  20.  do a manual install.  Don't worry it's very easy, any monkey
  21.  could do it.)
  22.  
  23. As root:
  24. 1. Type './configure' and it will determine all the right settings and 
  25.    directories for your system. 
  26. 2. Type 'make' and in theory it will build. If you are using a non-GNU system,
  27.    such as FreeBSD or Solaris, you will need the GNU version of make, often
  28.    installed as `gmake'.  If you get errors about "void *" see the FAQ.
  29. 3. Type 'make install' and licq will be installed (defaults to 
  30.    /usr/local).
  31. 4. Go to plugins/qt-gui and follow the directions there (doc/README) to install
  32.    the Qt interface plugin (necessary).
  33.  
  34. As each user:
  35. 5. When you run licq for the first time it will install all the necessary
  36.    files in ~/.licq.
  37. 6. You can import users from a number of other clients into Licq using
  38.    one of the conversion scripts found on the download section of the web
  39.    page or in the licq-data package.
  40.  
  41.  
  42. SOCKS5 Proxy Support:
  43. Licq supports SOCKS5 proxies.  To enable this support, run configure with
  44. --enable-socks5, and optionally --with-socks5-inc=PATH and 
  45. --with-socks5-lib=PATH.  Then just make sure all the right environment
  46. variables are set and it should work.  Also read the SOCKS.HOWTO file.
  47.  
  48. Licq requires the following:
  49. Some C++ compiler with proper standard c++ headers.
  50.  
  51. Licq has been compiled and run successfully on the following systems at one 
  52. point (note current versions may no longer compile without a bit of tweaking):
  53. Linux/x86
  54. Linux/Alpha
  55. Linux/PPC
  56. FreeBSD/i386
  57. AIX/RS6000
  58. NetBSD/mk68000
  59. Sun3/mk68000
  60. Solaris/x86
  61. Unixware
  62. Solaris/sparc
  63.  
  64. CONFIGURATION:
  65.  
  66. Configuration is done through the ~/.licq/licq.conf file, which contains .ini 
  67. style options.  Help on each option is include in the file.  The contact 
  68. list is stored in conf/users.conf.  Each users info is stored as a simple 
  69. text file called {user uin}.uin.  Again, the options are pretty obvious.  
  70. You can add/remove/edit a user inside the gui, or by editing the conf files.  
  71.  
  72. The History file is the file where the user history is stored...you can 
  73. specify a filename for each user, or you can put one of the following 
  74. keywords:
  75. none : no history file
  76. default : makes the history file history/<uin>.history
  77.  
  78.  
  79. USE:
  80.  
  81. Type licq -h for commandline help.
  82.  
  83. Using licq is fairly straight-forward.  Licq itself is merely a daemon
  84. designed to run various plugin interfaces.  I have written an advanted
  85. gui in qt (qt-gui) which should be used as the default plugin.  Once you
  86. have compiled and installed Licq, unpack the plugins you wish to use into
  87. the plugins/ directory, compile them, and then install them into 
  88. /usr/local/share/licq/plugins (replace /usr/local with the prefix given
  89. to configure if necessary).  Then start licq with the -p option:
  90. $ licq -p qt-gui -- ...any options to the plugin...
  91.  
  92. Note the -- which tells the system to pass any options after that on to the
  93. first plugin in the list.  Multiple plugins can be chained in this way:
  94. $ licq -p qt-gui -p email-forward -- <qt-gui options> -- <email-forward options>
  95.  
  96.  
  97. PROBLEMS:
  98.  
  99. See the BUGS file for reports on known bugs and problems.
  100.  
  101.  
  102. TROUBLE-SHOOTING:
  103.  
  104. 1. RUNNING
  105. o  Segfault at startup.  If this occurs, run licq with the -d 15 switch and tell
  106.    me how far it gets before segfaulting and I'll try and help.
  107.  
  108. Good luck.
  109.  
  110.  
  111. CONTACTS:
  112.  
  113. Send any questions, comments, or other complaints to 
  114. licq-devel@lists.sourceforge.net.
  115.